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LO INTRODUCTION 


This manual is deslgned to serv© as a Supplement to the ATARI 400™ and 
ATARI 800™ OPERATING SYSTEM MANUAL 

The 1200XL as shown in sections 3-5. is a technical Upgrade of the A800. The 
operating System tor the 1200XL has been wiitten to maintcdn as much as possi- 
ble. compatibility wlth appllcatlon programs whlch have alieady been 
developed tor the A400/800. 

Since the basic hardware which Controls the user Interface and the display is. 
tor the most pari compatible wlth the earlier designs. the operating System, ex- 
cept tor the enhancerrients or changes described here, has remained largely 
the same. Theretore the data contained in the OS manual tor the A400/800 is 
still valid. 

This manual has been written to provide the user wlth data regarding usage ot 
the added features ot the 1200XL operating System wlth some detalls about the 
characteristics ot the perlpheral devices with which it will operate. Program- 
mers or peripheral- developers who require a greater level ot detail regarding 
the handling ot peripheral devices should reter to the documents reterenced in 
item 2 ot section 2 below. 


2.0 APPLICABLE DOCUMENTS 

L ATARI Home Computer Operating Systems Manual 

Describes the OS tor the A400 and A800, which is the basis tor the enhance- 
ments described in this manual 

2 ATARI Home Computer Hardware Manual and 1200XL Supplement 

The Hardware Manual covers the hardware registers which control the 
various tunctions ot the A400 and A800. The Supplement to the hardware 
manual covers the added teatures tor control ot the 1200XL Home Compu¬ 
ter. Details that are approprlate to the OS handling ot such hardware 
registers are contained in this OS manual The user who has need tor other 
haidware-related data should reter to the hardware manual tor more 
Information. 

3. DE RE .ATARI _ 

^ This document provides-the user with an introduction to the efiective use ot 
the ATARI Home Computer hardware. Although written to cover the 
A400/800, the data contained therein is valid tor the 1200XL as well 





3.0 HOW THE 1200XL COMPAHES TO THE A400/800 

The tollowlng is a llst ot the teatures and tuncüons whlch will be discussed in this 
chapter. Each will be explained ln a separate section.. 

In this chapter, you will leam abouti 

L The HELP Key 

2. The Function Keys 

3. How key Codes are redeäned and whlch ones cannot be redeäned 
4 How to alter the key repeat rate 

5. The action ot the Caps/LowrKey 

6. How the OS initializes the LED's on the keyboard 

7. What happens when a cartridge 1s Installed or removed 

8. What happens during power-on sell-test 

9. What the Option jurnper assignments mean 

10. What new screen modes the 1200XL can use 
1L How to enable iine scrolling ot the text screen 

12. How the disk handler has been changed tor lmproved Operation 

13. What kind ot display is now produced at power-up 

14 What teatures have been deleted as compared to the A400 or A800 

Each ot the items enumerated above corresponds to the paragraph number in 
this section which tollows. For example, item 1 above Is covered in paragraph 
3.1 item 2 in paragraph 32 and so torth. 



ZA The HELP Key 



ot ine nriiT xwov 1 w u iwMuwui »w ww* -- ■ , , 

readbywhlchever appUcaüon progiam ls ln control at the tone and read 
accordingly. 

The OS treats the help üag ln the same way as the BREAK key ln that no KZASCU 
code is pioduced but a database variable ls set Therelore. ü 
nectina the HELP key to be pressecL you must not only read the keyjDoard HFO 
(hex location 02FC) lor incomlng ATASCII codes other than Help, but alsoocca- 
riowüly check ("poll") the contents ol the HELPFG (help üag) database variable 
to see 11 Help was requested. 

Help Flag ls cleared. by storing a zero ln its database variable. 

The loc a tion ol this variable ls S02DC. The condlüons to wlrich. lt responds aie 
Sed below, along wlth the codes whlch will be stored ln HELPFG, 


Hex value Condition represented 

The Help Üag ls cleared Thls üag ls cleared at Ini¬ 
tial power-up reset and subsequently, 11 set must be 
cleared by the application program 

HELP key alone was pressed 

SHIFT-HELP key combination was pressed. 

CTRL-HELP key combination was pressed 

The HELP key can be used during the power-on display and during the seil test 
leature. See those sections lor more Information. 


OO 

11 

51 
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3.2 What The FUNCTION Keys Do 

NOTE This section only applles to XL Computers with function keys. 

The 1200XL is provided with a set of tour function keys. You may redefine the 
ATASCII values which these keys produce if you desire. As a matter of fact the 
entire keyboard ATASCII output may be redefined as will be seen later. This sec¬ 
tion shows the normal definition of the F1-F4 keys, thelr functions and the ATASCII 
codes which they produce (if any) as a result of the power-on reset assignment.. 
All values in the table below are given in hexadecimal 

FUNCTION KEY ASSIGNMENT SUMMARY 

Key If pressed alone 

Fl Produces the Cursor-up function retums ATASCII IC 
F2 Produces the Cursor-down function retums ATASCII ID 
F3 Produces the Cursor-left function retums ATASCII IE 
F4 Produces the Cursor-right function retums ATASCII IF 

Key If pressed with SHIFT 

Fl See HOME CURSOR below 

F2 See CURSOR TO LOWER LEFT CORNER below 
F3 See CURSOR TO BEGINNING OF PHYSICAL UNE below 
F4 See CURSOR TO FAR RIGHT OF PHYSICAL UNE below 

Key If pressed with CTRL 

Fl See KEYBOARD ENABLE /DISABLE below 

F2 See SCREEN DMA ENABLE/DISABLE below 

F3 See KEY-CUCK ENABLE/DISABLE below 

F4 See DOMESTIC/INTERNATIONAL CHARACIER SET below 

Key If pressed with CTRL and SHIFT 

Fl Ignored 

F2 Ignored 

F3 Ignored 

F4 Ignored 

HOME CURSOR FUNCTION 

SHIFT-H causes the Cursor to move to the home Position of the screen as well as 
joroducing the default ATASCII code IC. The default function is reassignable. . 

CURSOR-TO LOWER LEFT CORNER 

SHIFT-F2 causes the Cursor to move to the lower left comer of the screen as well 
as producing the default ATASCII code ID. The default function is reassignable. 
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CURSOR TO BEGINNINGOF PHYSICAL LINE 

SHIFT-F3 ccruses th© cuisor io move to fhe far left of the physical lineon whichit is 
located (note. not the logioal line which. in the screen editor. could be as many 
cts 3 physical lines> This function is. perfoimed by the screen editoras well as 
^ne?attng the deiault ATASCD Code IE The default function is reassignable. 

CURSOR TO FAR RIGHT WTTHIN PHYSICAL LINE 

SHIFT-F4 causes the cuisor to move to the far right side of the physical lim on 
which it is located. This function is perfoimed by the screen editor as well as 
ginerating the default ATASCD code 1F. The default function is reassignable. 

KEYBOARD ENABLE /DISABLE 

CTRL-Fl Controls the keyboard enable/disable function. It produces no ATASCD 
code. This key combination affects the operating System handling of the key- 
boaid and is not reassignable. 

CTRL-Fl disables and re-enables ati keyboard functions except for the fotiowing. 
RESET is the 6502 RESET key and cannot be disabled 


keys are not controDed by the operating System 


OPTION 
START 
SELECT 

Each time you press CTRL-Fl the operating System changes the enabled/dis- 
Sed^atus to the opposite of what it was when you pressed this combination 
Tn other words. if the OS had disabled the keyboard, LED 1 would be on D, at thart 
time you press CTRL-Fl the OS would re-enable the keyboard andtum lHDl ott 
The second press of this combination would reveise the process, disabling the 

keyboard again 

You may monitor or control the keyboard enable or disable 
wäre control by ieading or wiiting the OS database variable ccüled KEYDIS 
(hex location 026D). A value of O in this location means the keyboard is 
enabled, and a value of hex FF here means the keyboard is disabled. 
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SCREEN DMA ENABLE /DISABLE 

CTRL-F2 Controls the Screen Enable/Dlsc±)le Direct Memory Access (DMA). It pro- 
duces no ATASCII code. This key combination aäects the operating System 
handling ot the display tunction This key combination is not reassignable. 

The 1200XL on power-up, always enables the screen DMA What this means 
is that the system will always initialize itseli to display anything which has 
been defined lor the screen display during power up. This same screen DMA 
enable will also occur ii you touch any keyboard key other than the CTRL-F2 
combination. 

Various types ot programs which you write may be heavily involved in arith- 
metic computations. To speed up the Processing in the A400 or A800, you may 
disable the screen DMA When it is disabled the ANTIC processor does not steal 
memory cycles trom the 6502 to get its data tor the screen. Theretore during dis¬ 
able mode, the screen remains blank. When it is enabled, the full display which 
you have deäned is visible,- however, the processor is slowed down by any- 
where trom IO to 40 percent as explained in the section on ANTIC DMA in the 
Atari Hardware Manual 

On the 1200XL to start the higher speed/ no display tunction press the CTRL-F2 
key combination. The display will go blank. To restore the display again at any 
time, you can press any other key 

During your arithmetic calculations. you may be in continuous process ot up- 
dating the memory area where the display data is contained You can then get 
a status ot the Operation in process at any time simply by pressing any key 
other than CTRL-F2, then again press CTRL-F2 to re-enter the higher speed mode. 

Your program, then on completion ot the calculation could exercise direct pro¬ 
gram control over the ANTIC DMA variable to restore the display when the 
arithmetic intensive pari is over. 

The DMA control database variable SMDCTL contains Status bits tor display list 
memory access as well as player missile data access. When the combination 
CTRL-F2 is pressed, the OS will save this value, (it it is not already zero) in data¬ 
base variable location DMASAV$02DD). Then the variable SMDCTL will be set 
to zero. When the combination is pressed again the original value is restored to 
SMDCTL trom DMASAV thereby restoring the display. Your program could per- 
torm +he same-process,. 



KEY-CLICK ENABLE /DISABLE 


CTRL-F3 Controls the Key-Click enable/dlsable function. If pressed once, it dis- 
ables the audible teedback on keyströkes. Pressed agcdn reenables it This func¬ 
tion only affects an OS database variable and produces no ATASCII code. It is 
not reassignable. 

You may Control the key click enable/disable from your program. All that 
needs to be done ls to change the same flag whicfi the operating System uses to 
indicate whether a key click is required This Üag is called NOCLDC It is one of 
the OS database variables, contained at location $02DB. 

On power up and reset the operating System initializes this variable to a value 
of OO, meaning that key click is enabled This location when it contains.the 
value $FF, indicates that no key click is desired The key combination CTRL-F3 
toggles it between the values OO and FF. 

DOMESTIC/INTERNATIONAL CHARACTER SELECTION 

CTRL-F4 Controls the domestic/intemational character selection Default is 
domestic. It affects an OS database variable only and produces no ATASCII 
code. It is not reassignable. It toggles the display of character sets, changing 
between the two each time the key combination is pressed. When the interna¬ 
tional character set is selected LED number 2 will be lit 

The international Version of the character set is located in the ROM beginning at 
location $CCOO You can cause the international character set to be selected by 
storing the constant $CC to location $02F4 This is the location CHBAS. The nor¬ 
mal character set is located in the ROM starting at SEOOO. If a program Stores 
$EO to CHBAS, it selects the display of the normal characters. 

If you have detined your own character set however, pressing CTRL-F4 will 
display the international character set This is because the operating System will 
test CHBAS and find that the value $CC is not there. Therefore $CC must be the 
next value which is to be used (selects intl set). When it tests CHBAS and ünds 
$CC stored there, it knows that $EO is the next value to use during the toggle 
between character sets. 

Two variables are used to control the character set selection CHBAS (02F4) and 
CHSA1T (026B). The Screen Editor (E.) and the Display Händler (SO initialize vari¬ 
ables CHBAS and CHS ALT at every OPEN command which you issue to either 
one. CHBAS is initialized to a value of hex EO and CHSAIT is initialized to a value 
of hex CC. 

When youpress CTRL-F4 the operating System swaps the values of CHBAS and 
CHSAIT using the OS variable TEMP as the temporary holding point. Once it 
completes the swap, if CHBAS is equal to CC, it will light LED 2, indicating that the 
international character set is selected 


7 



3.3 KEY REDEFINITION 


You may redefine most of the 1200XL console keys if desired The redefinition 
process consists of setting up a pair of tables which cctn be referenced by the 
operatirig System when it translates your keystroke into an ATASCII value. 

The two tables are the KEY Definition Table and the Function Key Definition 
Table. The operating System has a pair of data tables fiom which the normal 
definitions are made. You may define your own set of tables however, then 
simply teil the operating systen where they are located in memory 

One such use of key redefinition might be to experiment with other, possibly 
more efficient keyboard layouts, such as perhaps the Dvorak keyboard An ex- 
ample is given in Appendix A of a keyboard redefinition to allow you to do 
such an experiment. (Over the years, the QWERTY key layout has been the ac- 
cepted Standard, though many people have found DVORAK to be more effi¬ 
cient. This would allöw you to try it for yourseli) 



CONTENTS OF THE KEY DEFINITION TABLE 

This table allows most of the keys of the 1200XL to generate any desired ATASCII 
cod© or special internal function The exceptions to this are listed at the end of 
this section. To redefine the keys, it is necessary first to deäne an area in memory 
where a 192 byte table may be stored i- 

Into this table. you will störe the definitions ot thekeys which you desire. Later 
you will teil the operating System where this table is located so that future 
reterences may be made to it instead of the Standard deänition table. 

The Organization of this table is as follows« 


KEYTABLE _ START (Starts at user defined 
address) Table of lower case conversions 


Table of uppercase conversions 


Table of control key conversions 

KEYTABLE _ START + 19L 

The reason that each of the subdivisions of the table has 64 bytes in it is that the 
hardware can generate a total of 64 hardware keycodes. These Codes, num- 
bered 00-63 decimal (00-3F hexadecimal) are used to Index directly into one 
of the three keycode tables. Which table is referenced depends on whether the 
CTRL or SHIFT keys is pressed 

Note that there is no table for the combination of both CTRL and SHIFT. This com- 
bination is invalid and is ignored by the operating System. 

Each of the three 64 byte subsections of the table has the form 


Lower case convert 
Group of 64 bytes 

Shift plus key 
Group of 64 bytes 

CTRL plus key 
Group of 64 bytes 


OO code 


Ol eode 


3F code 


Byte O contains conversion for key code OO for key alone, 
key with CTRL or key plus SHIFT. Depends on 
which table is accessed per which keys pressed 

Byte 1 contains conversion for key code Ol 


Byte 3F contains conversion for key code 3F 


The codes which you place in your table will either generate an ATASCII code 
(for direct chaiacter translation) or they will teil the System to perform a specific 
function. Specifically any code in the ränge of 80 to 91 hexadecimal will be 
treated as special by the System This is illustrated in the table below. 
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CODES AND THUR EFFECT ON THE SYSTEM AFTER TRANSLATION 


CODE 

EFFECT (if any) 

OO thru 7F 

Used as the ATASCE code only 

92 thru FF 

Used as the ATASCE code only. 

80 

Ignore, invalid key combination 

81 

Lnvert the Video output to the screen 

82 

Alpha lock/Lower case toggle. 

83 

Alpha lock 

84 

Control Lock 

85 

End of file 

86 

ATASCE code 

87 

ATASCE code 

88 

ATASCE code 

89 

Key cEck on/off 

8A 

Function 1 * 

8B 

Function 2 * 

8C 

Function 3 * 

8D 

Function 4 * 


* NOTE: When it sees these keycode translations, it is told to DO the function 
which is described in the Function Key descriptions. The ATASCII coded gene- 
ration lor the normal and shifted function keys is handled in a different table, 
whose description follows that for the keycode hardware translate table. 

8E Cursor to home 

8F Cursor to bottom 

90 Cursor to the left margin 

91 Cursor to the right margin 

The table below shows the key cap conespondlng to each key code. The 
physical Position of each key switch within the table determines the hardware 
code which it will generate. To determine what code it is, take the row address 
of the cap, and add it to the column address. The result is the hexadecimal 
value retumed to the operating System (ränge 00-3F) for use in the table 
lookup for that key 



KEYCODE DEFINnTONS TABLE 



O 

1 

2 

3 

4 

5 

6 

7 

oo 

L 

J 

/ 

Fl 

F2 

K 

+ 

* 

08 

O 


P 

U 

RET 

I 


= 

IO 

V 

HLP 

C 

F3 

F4 „ 

B 

X 

Z 

18_ 

4 


3 

6 

ESC 

5 

2 

1 

20_ 

i 

SPACE 

• 

N 


M 

/ 

)l( 

28_ 

R 


E 

Y 

TAB 

T 

W 

Q 

30_ 

9 


O 

7 

BACKS 

8 



38 

F 

H 

D 


CAPS 

G 

S 

A 


As an example the key cap "C" is in the table in row IO. column 2. This mjans 
thcrt the hcrrdware generates a. hardware code IO + 

fnre in the tianslation tables shown above, the function code or ATAbCii coa 
iorthis character will be stored in the key deünition table Position $12toreachol 
the three tvpes oi “C" whlch aie valid (c alone. Shllted C. or Conüol C> You may 
cmie each of these to pertoim a separate function or generale a separate 
ATASCII code by revising the tables. 

When vou have decided on how you want your keys to be redetmed, you teil 
the ooerating System where it may find the deünitions by storing the address of 
hose deüStioS tii locations 79 arid 7A hexadecimaL The low byte of the hex- 
adecimal address where you have stored the keys should be placed ^ loca- 
tion 79 the high byte is location 7A This is defined as one of the System vectors, 
called KEYDEF. It will point to the default or original key deünition table at 

power-on reset time. 



REASSIGNMENT OF THE FUNCTION KEYS ONLY 


There may b© times when you only want to redeflne the tunction keys and not 
redefine the rest of the keyboard The 1200XL operaüng System allows you to 
redetine only the lunction keys by setting up an 8-byte.table in place ot the 192 
byte table which would have otherwise been required The tormat ot this table 
is as lollowsi 


<— Lowest memory location ot the table 


*— Highest memory location ot the table 


When you have decided what functions each combination must peitorm and 
have built the table, change the System vector FKDEF to point to the lowest ad¬ 
dress ot your table. This vector is located at memory locations 60 and 61 hexa- 
decimal. Location 60 gets the low byte ot the hex address, location 61 gets the 
high byte. 

The same codes described in the section titled ''CODES AND THEIR EFFECT ON 
THE SYSTEM AFTER TRANSLATION" are used in this table. However, DO NOT 
assign codes 8A through 8D to the same tunction as the key itsell In other words, 
do not specify that the key Fl should pertorm tunction FL etc. since this would 
result in an infinite loop. (Fl sensed by the OS sends it to the tunction key table, 
which teils it to look up and pertorm the Fl tunction which sends it to the table, 
and so on with no possible exit.) 





\ 

NON-REASSIGNABLE KEYS AND KEY COMBINATIONS 


Th© tollowing keys or key combincrtions are either specifically wired tor special 
tunctions or ar© subjected to special handling by the operating System. 


Fven thouah there might b© a hardware-generated key cod© shown in th© 
FS rSa conespondlng space ln the taandato tables. there Isnoway 
to reassign these tunctions. This is because the operating system traps the hard- 
ware cod© directly to pertorm the speciüed tunction and it never gets to the 
translat© mode. These keys or combinations are as tollows. 


BREAK 

SHIFT 

CTRL 


This tunction is tixed as a special case in the operating 
system It is sensed by the hardware. 

This key is an integral pari ot the hardware encoding ot 
any key tunction 

This key in an integral pari ot the hardware encoding ot 
any key tunction 


OPTION 

SELECT 

START 

RESET 

HELP 


CTRL-1 


CTRL-Fl 


CTRL-F2 


_ All ot these are directly wired to and are sensed by the 

GTLA circuiiry. 

Directly wired to the 6502 reset line. 

Function is tixed by the operating system The help tunc¬ 
tion handling is descrlbed elsewhere in this manuaL 

Controls the screen output start/stop tunction 

See KEYBOARD ENABLE/DISABLE above. As noted there. 
this tunction is not reassignable. 

See SCREEN DMA CONTROL above. As noted there. this 
tunction is not reassignable. 


CTRL-F3 

CTRL-F4 


See KEY-CUCK ENABLE/DISABLE above. As noted there, 
this tunction is not reassignable. 

See DOMESTIC/INTERNATIONAL CHARACTER SET above. 
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3.4 USER-ALTERABLE KEY AUTO-REPEAT RATE 

The 1200XL operating System allows you to control the rate at which a key, con- 
tinuously held down, will repeat lts entry to the System. Thls chcmge can be 
done by modifying the OS database variable KEYREP,. located at hex address 
02DA 

Thls variable determines the repetition rate by counting the number ot VBLANK 
(veiücal blanking) intervals which occur. For the NTSC (60 Hz) System the initial 
value ot thls variable is 6 t tor PAL Systems, the value is 5. This assures a unilorm 
repeat rate ot IO characters per second tor either System The key repeat rate 
equals the VBLANK rate (60 or 50 per second) divided by the KEYREP value. 

Under control ot this variable, the maximum “controllable" key repeat rate 
would be 50 characters per second on the PAL and 60 characters per second 
on the NTSC (screen retresh rate). This would occur with a value ot 1 in this 
variable. 

You may control the rate at which occurs betöre the key repeat Starts The OS 
database variable which Controls this is called KRPDEL lts hex address is 02D9. 

It Controls the number ot VBLANKs which must occur between the sensing ot the 
key pressed until the first repeat occurs. From that time on. the repeat rate is con- 
trolled as described above. The initial values used by the OS provide a 0.8 sec¬ 
ond initial delay tor either NTSC (count = 48) or PAL (count = 40) Systems. 


3.5 CAPS/LOWR KEY TOGGLE ACTION 


The CAPS/LOWR key on the 1200XL functions as shown in the chart 


KEY COMBINATION 

CAPS 

CAPS 

CAPS 

SHIFT-CAPS 
CTRL-CAPS 
CTRL- SHIFT- CAPS 


CURRENT STATE 

Control Lock 
Alpha Lock 
Lower Case 

— any — 

— any — 

— any — 


below. 

NEW STATE 

Lower Case 
Lower Case 
AJpha Lock 
Alpha Lock 
Control Lock 
— no change — 


The meaning ot the terms is as tollows: 

Lower pase - — All key caps respond in lower case mode 

Alpha Lock All alphabetic keys (A-Z) respond in upper case mode, 

all others lower case 


Control Lock 


All alphabetic keys (A-Z) respond as though the control 
key is being held down as well as the selected key 
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3.6 LED INITIAL1ZATION 

The ßOOXL h^ twoondhe coüed 

lit th J^h Ypt is selected. The operating System enables the key- 

Pow« up and zeset Thereiore 

these LED's will both be oft 


€ - 


3 7 POWER-ON SELT-TEST 

ss “ “ 

a Is it possible to wrlte SFF (all ones) to all RAM locaüons? 

b. is it possibl e to wüte SOO (aU zeros) to all RAM locaüons? 

c. Does a checksum ot the two ROM's compare to that stored within each ROM? 

place. 

3.8 OPTION JUMPERS 

The 1200XL Is provtded wlth a set of 

to teil the operating System how the System d Sfeciücally JL This is 
base variable JMPERS. location 030E. 

jassstrÄÄSÄ 


Brr 

o 

1-3 

4-7 

s 


FUNCTION 

Seil test enable (will run seil test il low) 

Reserved lor luture use 

Unused 


HARDWARE NAME 
J1 (pot 4) 


15 



3.9 ADDITIONAL HARDWARE SCREENMODES 


The 1200XL adds direct access to the remainlng special purpose display pro 
cessor operating modes The table below shows the current mapping which 
has been provided tor the A400 and A800. The table which tollows thereatter 
shows the added modes and the numbeis which the Software can use to access 
the extra modes. 

Mode mapping common to A400/A800i 


Software Mode 

O 

($00) 

1 

($01) 

2 

($02) 

3 

($03) 

4 

($04) 

5 

($05) 

6 

($06) 

7 

($07) 

8 

($08) 

9 

($09) 

IO 

($OA) 

11 

($0B) 

Mode mapping tor 

Software Mode 

12 

($OC) 

13 

($OD) 

14 

($OE) 

15 

($OF) 


ANTIC MODE 

GTIA MODE 

2 

($02) 

O 

6 

($06) 

O 

7 

($07) 

O 

8 

($08) 

O 

9 

($09) 

O 

IO 

($OA) 

O 

11 

($OB) 

O 

13 

($OD) 

O 

15 

($OF) 

O 

15 

($0F) 

1 

15 

($0F) 

2 

15 

($0F) 

3 

1200XL (additional), 


ANTIC MODE 

GTIA MODE 

4 

($04) 

O (note 1) 

5 

($05) 

O (note 1) 

12 

($OC) 

O 

14 

($OE) 

O 


Note L The existing character sets will not provide recognizable characters tor 
these new modes. Theretore you will have to provide the character set it 
you use these modes. This is done by defining the tull character set then 
moditying the OS database variable CHBAS to point to the most signifi- 
cant byte ot the address at which the character set Starts CHBAS is 
located at $2F4. 


Appendix B ot this manual contains some suggestions on the method tor 
desighing a new' character set to support those added modes. 
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3.10 TEXT SCREEN FINE SCROLLING 

The screen editor (B) supports fine scrolling of the text screen data as ^Option 
This fine scrolling Option will be enabled 11 the dätabase variableTlNE (hex 
löeaüon 026E) ls set nonzero piior to issuing the OPEN dommand to the screen 
editor. Likewise, the lecrtuie will be dlsabled 11 this loeation is set to OO before 
issuing the OPEN. 

There are only two allowed values for FINE — O and hex FF. Other values may 
produce undesirable results. 

Duiing an OPEN command to the Screen Editor (E.). ilFINE (026E) is hex FF. then 
a fine scrolling display list ls created This dlsplay llst will be one byte larger than 
a coarse scrolling dlsplay llst. In addition the OS places the address of a dlsplay 
£t Stenupt rouüne tato the dlsplay llst vector VDSLST (0200) replacing an 
other vector whlch you might have already stored there. 

When üne scrolling is enabled the Screen Editors dlsplay llst Interrupt Service 
routine modliies the content of color register COLPF1 (D017) for the very last visi¬ 
ble line of the screen 

When a CLOSE command ls issued for the Screen Editor, if FINE is hex FF. then the 
ÄS tato the display llst vector VDSLST (0200). For OS ver- 

sions 11 and beyond FINE is set to zero again and the screen is reopened with a 
coarse scrolling display list 

The recommended manner for enabling and disabling fine scrolling is shown 
belowi 

cl Set FINE to hex FF 


b. OPEN E. using an IOCB number 

c. Use E. as usual- fine scrolling ls enabled 


d CLOSEE. 

e. If the IOCB is now open then you are finished otherwise continue 
with the next step 

t Set, FINE to zero 

g. OPEN E. 
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3.U DISK COMMUNICATIONS ENHANCEMENT^ 

The 1200XL adds the capability tor the resident disk handler to read and write 
disk sectors having variable length irom 1 to 65536 bytes. The detaultlength as is 
used on the A400 and A800 currently, is 128 bytes. Both.at power-on and RESET 
(warm start), the 128 byte sector length is established. Your program can alter this 
length by moditying the OS database variable DSCILN. The location ot thistwo* 
byte variable is 02D5 and 02D6 (lo byte in 02D5. hi in 02D6). 

In addiiion to the capability to read and write variable length sectois. the 
1200XL also adds the capability to write a sector to the disk without a read* 
veriiy Operation always iollowing it. This is the command which was specific- 
ally excluded in the previous releases ot the operating System. 

With this capability added you have a choice ot either using the verity, tor Sys¬ 
tem integrity (always read atter weite} Or you can take a chance ot writing a 
bad sector on rare occasions but increasing your average speed ot disk usage 
by some value related to the verity time. You mcty want to experiment with 
some ot your programs with and without verity to see the results. 


3.12 POWER-ON DISPLAY ENHANCEMENT 

In place ot the original power-on memo pad display used by the A400 and 
A800 (in the absence ot a cartridge or disk), the 1200XL displays a dynamic 
ATARI rainbow. It you press the HELP key while the rainbow is displayedL the 
1200XL will enter the selt-test mode. 



4.0 MEMORY MAP OF THE 1200XL 

The foilowing table shows how the 6502 processor perceives the various ad¬ 
dress spaces whlch it can access. The maximum allowable address ränge, with 
the 16 bit address ol the 6502 is hexadeclmal OOOO-FFFF. This address ränge is 
split by the hardware memory management circultry. as lollows, 


('Note- The 1200XL uses 64K RAM's as the main System writeable memory Ad- 
dresses wlthin those RAM's. which would noimally have fiUed the entire 
memory access space ot OOOO-FFFF ol the processor. are prevented Irom ac¬ 
cess by the memory manager. This allows ROM's, cartridge memory. and pen- 
pherals to occupy a part ol the memory space as is noted below.) 


1200XL MEMORY MAP 


HEX ADDRESS 

FFFF-D800 

D7FF-DOOO 


WHAT IS ACCESSED THERE 

OS-ROM or RAM il ROM disabled 

The special purpose Chips respond to 
the address ranges shown in the listing 
below 


DOOO-DOFF 

D200-D2FF 

D300-D3FF 

D400-D4FF 

D500-D5FF 


GTIA 

POKEY 

PIA 

ANTIC 

Any read or write 
to an address in 
this ränge enables 
the cartridge con- 
trol line CCNTL on 
the cartridge inter- 
lace (same as ’ 
A400/A800. 


NOTES 

1 


CFFF-COOO 

BFFF-AOÖO 

9PFF-8000 

7FFF-5800“' 

57FF-5000 

4FFF-0000 


DIOO-DIFF, D 6 OO-D 6 FF. and D700-D7FF 
are reserved lor luture use. 

OS-ROM physically present but cannot 
be accessed here. 2 

OS-ROM or RAM il ROM is disabled 1 

RAM or cartridge interlace 3 

RAM, or cartridge interlace 3 

RAM 

RAM. unless in sell-test mode 2 

RAM 
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NOTES: L Access to the OS ROM may be disabled by wlitlng a zero to port B ol 
ihe PIA bit O. Access is normally enablect with a 1 present ln this bit 
(When changing this bit in the register. other bits should not be 
changedL) 

2. The sell-test ROM code is physically present in the OS ROM at actual 
address DOOO-D7FF. However. this area is used lor the access to the 
memory mapped I/O devices. When the seli-test teature is invoked. the 
RAM located from 5000-57FF is disabled. The memory manager re- 
maps the memory access such that the OS ROM physical addresses 
DOOO-D7FF are accessed at 5000-57FF. The memory manager uses 
port B oI the PIA bit to determine whether to access RAM or ROM in the 
region 5000-57F. II bit 7 is high. RAM is accessed. II bit 7 is low, the OS 
ROM is accessed instead. (When changing this bit in the register, other 
bits should not be changed.) 

(Port B was used in the A400/800 to Service the game ports 3 and 4 
The use ol the remaining bits ol ths port are specilied in Section 6 ol-this 
manual) 

• 3. ROM will be selected in these regions il control lines RD4 or RD5 are 
pulled up to +5V by the cartridge. RD4 Controls ROM select in the 
region 8000-9FFF. RD5 Controls ROM select in the region AOOO-BFFF. 



5.0 ENHANCEMENT^ TO THE A400/800 REV. B OPERATING SYSTEM 
INCORPORATED IN THE 1200XL 

This section desciibes a set ot enhancements which include new methods ot 
handling peripherai products and in a separate section improvements in 
basic operations otthe systemThe latter might be reterred to as “bug fixes". 

PERIPHERAL HÄNDLER ADDITIONS 

To accommodate a new dass ot peripherai devices, the operating System now 
includes a relocating loader. used to upload peripherai handlers through the 
serial (I/O interiace). 

In the A400/800, device handlers tor the peripherals were uploaded as fixed 
location (absolute) object code. These handlers were loaded using a set ot de¬ 
vice inquires, or polls, known as types 0.1 and 2 Intonnation on types O, 

1 and 2 Poll Commands is available from Atari Customer Service. 

The 1200XL adds two other types ot polls to its operating System One pdl 
known as type 3, is issued at power-on or reset time. The other, type 4 can be 
issued as a result ot an OPEN command by an application progiam 

Type 3 Poll Command 

The type 3 poll command itselt is used as an “Are You There? type ot com¬ 
mand. Associated with the type 3 poll are two other types, specifically the« 


a) Poll Reset 
and b) Null Poll 

Poll Reset consists ot the tollowing SIO command byte sequence (reter to the SIO 
document tor turther explanation ot the byte types). 


Byte Position 

Device Address 
Command Byte 
AUX1 
AUX2 

Command Checksum 


Value (hex) 

4F 

40 

4F 

4P 

Normal (checked by peripherai) 


The 4F M AUX1 and AUX2 detine this sequence to all peripherals as a poll reset 

Arier responding to a type 3 poll by sending a handler to the system a peri¬ 
pherai is not supposed to respond again to a type 3 poll The Poll Reset com¬ 
mand, at power-up. resets all type 3 peripherals, treeing them to respond to the 
poll request. However. no serial bus device sends back any data as a result ot a 
poll reset command 
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Typ© 3 Poll (Ai© you there?) 

There may b© several types of peripherals which can respond to a type 3 polL 
In types O.1 and 2. th© device address sent on th© serial lln© speciäes which 
exact device is being cailed. In the type 3 poll Processing, however, the address 
remains fixed (4F) and the devices each respond öfter a speciftc number of poll 
3 retries. In other words, during poll 3 operations, the Computer doesn't know 
which peripherals are actually attached bufwill keep asking "is anybody 
there" until it has reached its last retry and no peripheral has responded. 

Each peripheral which does respond to the type 3 poll must be designed to 
count the number of retries of type 3 polls, then to respond as described below 
on its own specilied retry slot. Each time it sees a command other than a type 3 
poll these peripherals must reset their retry counters. This allows the Computer to 
load the handler for each peripheral which responds, then restart its poll 3 se- 
quence (original retry number restored) to look for another poll 3 response from 
the next peripheral (if any). 

Since each peripheral responds only once (alter a poll reset), a second request 
at a specific retry slot causes no peripheral Tesponseand allows the next retry 
slot to be polled 


This poll ("are you there?") is sent as follows; 


Byte Position 


Value (hex) 


Device address 
Command Byte 
AUX1 
AUX2 

Command checksum 


4F 

40 

OO 

OO 

Normal (checked by peripheral) 


When öfter checking the retry count. it is a peripheral's tum to respond it sends 
back the following data to the Computer on the serial Interfaces 


a) An ACK response byte, and 

b) L Low byte of handler size in bytes (must be EVEN) 

2. High byte of handler size 

3. Device Serial I/O Address to be used for loading 

4. Peripheral Revision Number 

These four bytes, if sent by the peripheral will be stored in OS variables DVSTAT 
(Q 9 FA hex) through DVSTAT+3. If there is a successful retum to the OS (not a 
'timeout or other problem), it indicates that there is a handler to be loaded The 
loading is performed then the type 3 poll is repeated until all retries are ex- 
hausted and no peripheral responds. 

Once the device address data is received from the peripheral during this type 3 
poll it can thereafter be referenced directly on the serial bus by its address in 
place of the original poll address 4F. 

Specific deiails of the actions taken by the OS after receiving an answer from a 
peripheral may be found in Appendix C. 
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Null Poll Commcmd 


This command is used as a seriell bus no-operation. II cmy error should occur 
duiing loadlng of a peripheral handler or by the relocator. the System should be 
öee to “back out" of the linklng of the faulty loader and teil the peripherals that 
it is ready for the next one to be loaded Since this null poll is a non-type-3 poll 
all peripherals will have reset their retiy counters and should be ready for 
another sequence of retries. looking for their own response retry slot. This mcän- 
tains synchronization between the Computer and the peripherals. 

The stiucture of the Null Poll is as follows: 


Byte Position 

Device Address 
Command Byte 
AUX1 
AUX2 

Command Checksum 
Type 4 Polling 


Value (hex) 

4F 

40 

4E 

4E 

Normal (peripherals check it) 


This type of poll is sent out on the serial bus as a result of an application initiated 
request. Düring an OPEN command a device which responds to a type 4 poll 
may conditionally or unconditionally be polled to determine if it is online and 
may or may not have its handler uploaded and linked to the System under con- 
trol of the OS. Detailed information regarding the handling of the device under 
various operating conditions may be found in Appendix. C. 


The Type 4 Poll is a serial port command structured as followsi 

• Device address of 4F hex (peripherals looking for Type 4 Poll may ignore the 
device address and look only for the poll command however, the device 
address will always be 4P hex and the peripheral may check this); 

• Command is (40 hex) (peripherals looking for this poll will always look for 

the command); 

• AUXL contains the device name, which is an ATASCII upper-case letter (ränge 
41 hex through 5A hex) (the peripheral must be assigned that device name in 
order to legally answer the poll),-- 

• AUX2 contairis the device number, which is an ATASCII digit (ränge ATASCII 1 
through 9,31 hex through 39 hex) (the peripheral may optionally use this infor- 
maöon in deciding whethe or not to answer the poll); 

• Standend command checksum (peripheral checks this). 

This poll differs from the Type 3 Poll in that the device name and number is in- 
cluded in the poll Therefore the peripheral need not count retries of the type 4 
poll and should answer the poll as soon as the poll command is recognized 
There is no limitation on the type 4 poll; the peripheral should answer its type 4 
poll each time it is issüed 

The peripheral response to a type 4 poll is the same as for the type 3 poll The four 
response bytes are placed by the Computer, into DVSTAT through DVSTAT+3 
(02EA through Q2ED hex.). 
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GENERAL ENHANCEMENTS TO THE REV. B OS FUNCTIONS 

The following funcüons which are suppoited by the A400/800 Rev. B Operating 
System have been further enhanced by the addition of the following teatures : 

Printer CLOSE wlth data ln the butter — - 

The printer handler will insert an EOL(end-ot-line) character in the Printer butter, 
it one is not there. betöre sendlng the butter to the printer on a CLOSE This 
assures that the last line will be printed immediately rather than having the 
Printer torced offline to output the final line. 

Printer Unit Number Handling — 

The printer handler has been changed so that it will process the unit number in 
the IOCB, allowing separate addressing tor Printers PI through P8. 

CIO Handling ot Truncated Records on Read — 

The CIO now places an EOL in the useris input butter on theoccurrence ot either 
a record longer than the butter being read or an EOF being encountered during 
the read attempt This assures that all records are accessible. even it the user has 
not provided a sufflcient butter size, he will at least get as much ot the record as 
he has provided tor. 

CIO Error Handling With Zero Length Buffer — 

The CIO will retum a butter length ot zero (in the 6502 A-register) when there is a 
handler error while efiecting a zero length butter transter. (See CIO section in the 
OS manual.) 

Display Handler Cursor Handling — 

The display handler now accepts a screen clear code no matter what value is 
in the Cursor X and Y Coordinates. 


Display Handler/Screen Editor Memory Clearing — 

The Display handler and Screen editor will not clear memory beyond the end 
ot memory as indicated by RAMTOP. Now it is possible tor the user to specify the 
top ot memory to be used by the System and to störe device handlers or per¬ 
sonal machine code in the memory area above the display. Changing display 
graphics modes, then. will not erase any data which has been placed in the 
RAM area above that assigned tor use by the display or screen editor. 

Rework,.of the Floating Point Package — 

The 1200XL operating System corrects a bug in the Rev. B OS. It now produces an 
error Status when an attempt is made to calculate the LOG or LOGIO ot zero. 


New ROM Vectors — 


The following fixed entry point vectors have been added to the!200XL ROM set: 


E480 JMPPUPDIS 
E483 JMPSLFTST 
E4Ö6 JMPPHENTR 
E489 JMPPHULNK 
E48C JMPPHINIS 


entry to power-on display 
entry to the self-test pgm. 
entry to uploaded handler enter, 
entry to uploaded handler unlink, 
entry to uploaded handler inti. 
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6.0 OTHER CHANGES/GENERAL INFORMATION 


This section deals wlth items which involve operating System changes, but 
which do not easily üt into any other categoiy 

IMPROVED HANDLING OF OS DATABASE VARIABLES 

Düring normal power-on sequence (cold stait), the OS database variables from 
$03ED-$03FF are set to zero. Düring a RESET (Warmstart), they are NOT changed 
by the OS. This means that an enhanced Version ot the operating System in the 
future will be able to make use oi these locations without reloading them öfter 
any RESET Operation. 

These bytes are all reserved lor use in future OS revisions. 

NTSC/PAL VERSION TIMING PROVISIONS 

There are various timing diäerences between the NTSC (60 hz) and the PAL (50 
hz) versions. To eliminate the necessity for providing a special operating sysfem 
ROM set ior each one, the specific timing adjustment values are handled within 
the single ROM set. 

To determine which type of System the ROM is operating on the operating Sys¬ 
tem checks a flag within the GTIA Chip and adjusts all timings accordingly. This 
was possible because the GTIA must be different to handle the modified display 
format for the 50 Hz Version By making certain timings a function of the state of 
this flag it was possible to make extemal timings independent of the NTSC or 
PAL System itself 

The timing values relate to the handling of the 115 Volt cassette player (Atari 410) 
and the console auto-repeat rate as shown in the table below: 


CASSETTE TIMINGS NOW INDEPENDENT TIMING 


Write Inter-record gap (long) 3.0 sec. 

Read IRG delay (long) 2.0 sec. 

Write IRG (short) 025 sec. 

Read IRG delay (short) 0.16 sec. 

Write File leader 192 sec. 

Read Leader delay 9.6 sec. 

Beep cue duration 0.5 sec. 

Beep cue Separation 0.16 sec. 


AUTO-REPEAT FUNCTIONS NOW INDEPENDENT TIMING 

Initial delay for-auto-repeat 0.8 sec 

itepeat rate 10.0 char/sec. 


1200X1 OS ROM IDENTIFICATION AND CHECKSUM DATA 


Each of the two ROM's in which the 1200XL operating System is contained has a 
capacity of 64K bits organized as 8K by 8. Within each of the ROM's is a block of 
data organized as shown in the diagram below, to identify the ROM and to give 
its checksum The checksum is tested by the operating System as pari of the 
power up sequence. 
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The format of the block for the COOO-DFFF ROM is as follows, 


ROM Cksum (lo) 

COOO 

ROM Cksum (hil_ 

COOl 

Dl 

Dl 

C002 

Ml 

M2 

C003 - 

Y1 

Y2 

C004 

ODtion bvte_ 

C005 

Al 

COOö 

A2 

C007 

NI 

N2 

COOÖ - 

N3 

N4 

C009 

N5 

Nö 

COOA 

Revision No. 

COOB 


Checksum which is the sum of all 
bytes in ROM except checksum 

bytes themselves. 


Revision date having the form 
DDMMYY where D = day digit 
M = month digit Y = year digit 
Each a 4 bit BCD digit ReservedL 
contains $00 tor the 1200XL 


Part number having the torrn 
AANNNNNN, where A's represent 
ASCÜ characters, N are BCD digits. 


The tormat of the Identification block for the EOOO-FFFF ROM is as follows: 


Dl 

D2 

FFEE 

Ml 

M2 

FFEF - 

Y1 

Y2 

FFFO 

ODtion bvte 

FFF1 

Al 

FFF2 

A2 

FFF3 

NI 

N 2 

FFF4 - 

N3~ 

. N4 

FFF5 

Nö' - 

, 'N6 

FFF6 

Revision No.— 

FFF7 

ROM Cksum (lo) 

FFF8 

ROM Cksum (hi) 

FFF9 

vector table for 
for NMI RES and IRQ 

FFFA-FFFF 


Revision date having the form 
DDMMYY where D = day digit 
M = month digit Y = year digit 
Each a 4 bit BCD digit 
Hardware product identifier, will 
be used by Atari to identify Home 
Computer products, for 1200XL = $OL 


Part number having the form 
AANNNNNN, where A's represent 
ASCII characters, N are BCD digits. 


Checksum which is the sum of all 
bytes in ROM except for checksum 
bytes themselves. 

This area reserved for power-on 
reset vectors, NMI and IRQ vectors. 
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PORT B CHANGES 


Port B of the PIA is a read/write port which no longer is connected to game I/O 
ports. Instead its bits control various tunctions which include control ot LED l LED 
2, read enable ot the the OS ROM's and other tunctions. To change only one 
single bit at a time within that port the toliowing technique should be used 

Clear A Bit (bit b) 

LDA PORTB 
AND # $FF-b 

STA PORTB ,clears only bit b in the port 

Set A Bit (bit b) 

LDA PORTB 
ORA # b 

STA PORTB ; sets only bit b in the port 




XL PORTB ($D301) BIT ASSIGNMENTS 

BIT 

VALUE 

USE 

O 

O 

OS ROM DISABLED, RAM ENABLED 


1 

OS ROM ENABLED 

The memory region mapped to the OS ROM is from $COOO 
to $FFFF except tor the region from $DOOO to $D7FF which 
is always mapped to the hardware I/O Chips (GTLA POKEY, 
PIA ANTIC). 

1 

O 

BASIC ENABLED 


1 

BASIC DISABLED, RAM ENABLED 

The memory region mapped to BASIC is from SBFFF. 

2 

O 

LED #1 ON 


1 

LED #1 OFF 

3 

O 

LED #2 ON 


1 

LED #2 OFF 

4 


RESERVED FOR FUTURE USE 

5 


RESERVED FOR FUTURE USE 

6 


RESERVED FOR FUTURE USE 

7 

o 

SELF TEST ROM ENABLED 


1 

SELF TEST ROM DISABLED, RAM ENABLED 


-- 

The memory region mapped to the seif test ROM is from 



$5000 to $57FF. 


"7 


NOTE The OS VBLANK process copies the port A Joystick and paddle values 
into the Port B shadows. Thus, stick O attects both O and 2, stick 1 affects both 1 
and 3. 




REV-LEVEL DETERMINATION 

To allow program products to determine whlch Atari Home Computer and 
Operating System Revision level it is operating with. the tollowing tests are 
recommended. 

If location $FCD8 = $A2, then product is an A4Ö0/A800 wherein: 

It location $FFF8 = $DD and $FFF9 = $57 
then OS is NTSC rev A 

It location $FFF8 = $D6 and $FFF9 = $57 
then OS is PAL rev A 

It location $FFF8 = $F3 and $FFF9 = $E6 
then OS is NTSC rev B. 

It location $FFF8 = $22 and $FFF9 = $58 
then OS is PAL rev B. 

Otherwise, it is some tuture A400/A800 OS. 

It location $FCD8 not $A2. then product is a 1200XL or other tuture home com- 
.puter product whereini 

It location $FFF1 = $OL then OS is 1200XL 
and location $FFF7 will be the 
internal rev number tor the 1200XL OS. 

Otherwise, location $FFF1 = product code tor 
tuture Atari Home Computer product 
and location $FFF7 contains OS rev 
level tor this product. 



APPENDIX A — AN EXAMPLE OF KEYBOARD REASSIGNMENT 

As suggested earller in this document the keyboard lunctions may be reas- 
signed. The table below gives the corresponding keys tor the Dvorak (also 
known as the American SimpMed) Keyboard. When the typewriter was ärst 
invented in 1867; Christophe! L Sholes chose a layout tor the keys which would 
slow down the good typists ot his day and thereby prevent his machine trom 
Jamming. This keyboard has endured to this day ,, 

In 1932. August Dvorak invented this key layout which places the most otten used 
characters, including the vowels, on the "home" key line and also redistributes 
the keystrokes trom a 60-70% left-hand activity to an almost 50/50 activity Cer- 
tain manutacturers cunently öfter this key layout as an Option. Now you can try 
it tor yourselt it you wish Only the list ot key correspondence is given here. It is 
lett to the reader to compose the key tunction table using the data contained 
earlier in this manual 


TOP ROW OF KEYBOARD 

CENTER ROW 

BOTTOM ROW 

Current 

Dvorak 

Current 

Dvorak 

Current 

Dvorak 

Q 

? 

A. 

A 

Z 

l 

q 

/ 



z 

; 

w 

4 

S 

O 

X 

Q 

w 

4 





E 

, 

D 

E 

C 

j 

e 

, 





R 

P 

F 

U 

V 

K 

T 

Y 

G 

I 

B 

X 

Y 

F 

H 

D 

N 

B 

U 

G 

J 

H 

M 

M 

I 

C 

K 

T 

4t 

W 





4t 

w 

O 

R 

L 

N 

• 

V 





- 

V 

P 

L 

; 

S 

? 

Z 



; 

s 

/ 

z 

14 

ii 

40 

.(underline) 



‘/2 

i 

i 

_ 
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APPENDIX B — SUGGESTIONS POS THE CONSTRUCTION OF A NEW 
CHARACTER SET FOR THE NEW GRAPHICS MODES 

This appendix covers the new graphics modes 12,13,14 and 15 now provided on 
the 1200XL Modes 14 and 15 are pure graphics modes v/ith resolutions ol 160 by 
20 and 160 by 40 respectively Since these are not eharaoter modes, the discus- 
slon below will be limited only to modes 12 and 13. 

Giaphics 12 and 13 do not produce recognizable characters, ior the most pari, 
using the Standard character set. One will understand why this is true by exam- 
ining the iollowing comparison between Graphics mode O to 12 and 13. 

Mode O is a 40 character mode. Each character is tormed trom an 8 
wide by 8 high pixel matrix. Each pixel is one bit wide in memory and is 
l h ot a color clock wide on the screen 

Modes 12 and 13 are also 40 character modes. However, each character' 
is tormed trom a 4 wide by 8 high pixel matrix, with each pixel 2 bits 
wide in memory and one color clock wide on the screen. This torces the 
character to be the same width as that used in Graphics mode O, but 
cannot convey the same intoimation within 4 pixels as with 8 as tar as 
character recognition is concemed. (It is ditticult to form a recognizable 
character in a tour by eight dot matrix). 

Let's examine how the 4-pixel character is tormed, agcdn comparing the way 
the 8-pixel character is tormed in mode Ot 

Mode O has a choice ot two colors tor each pixel (the hardware man- 
ual says 1 K h colors, but it is actually either the hue and luminance ot 
playtield 2 it there is a zero bit in the selected pixel Position, or the hue 
trom playtield 2 with the luminance ot playtield 1 it there is a 1 bit in the 
selected pixel Position. Theretore, each single bit in the character detini- 
tion byte tor a given line occupies a single Vi -color-clock-wide pixel 
Position. The character set built into the OS deünes the characters in an 8 
by 8 matrix. 

Mode 12 also uses 8 scan lines per character. However, it uses the 
character bytes in a ditterent manner. Each ot the character bytes 
retrieved by the ANTIC is treated as a set ot tour two-bit quantities, where 
each bit pair desciibes the color which is to be applied to one ot the 4 
single color-clock-wide pixels which are pari ot the character. Mode 13 is 
the same in its treatment ot the data bytes, but each ot the characters is 
double-hBight (16. scan lines instead ot 8) and each data byte is used 
twjce which efiectively doubles the height ot the character. 


30 



Let's look at a typical character, for example a W. The bits whlch form a W in the 
delault character set are similar ta the following 

1 0 0 0.0 0 O 1 display. 

1 O O O O O O 1 

1 O O 1 1 O O 1 , 

1 O O 1 1 O O 1 

1 O 1 O O 1 O 1 

1 1 O O O O 1 1 

1 1 O O O O 1 1 

1 O O O O O O 1 

(NOTE: This is not the exact representatioa but 1s used as an example of conect 
Interpretation in mode O and incorrect inteipretation in modes 12 and 13.) 

If you view the sample set of bytes, each at consecutive addresses within the 
defined character set it actually looks like a W when you trace the outline 
f.~ formed by the Ts in the byte set, as shown in the display example to the right of 
"'••• the byte representation. 

In this mode O display, each of the Ts would be one color, and each of the zeros 
would be another color, assuring a readable display 

For the modes 12 and 13. the four (not 8) pixels are controlled as follows. 

II two-bit value is. Then the ptxel color is* 

OO the background color 

Ol the playfield O color 

10 the playfield 1 color 

11 the playfield 2 color 

(if bit 7 of char = O) 

11 the playfield 3 color 

(if bit 7 of char = 1) 

I For the example shown, thea the 4th line from the bottom would display a IO IO 

Ol Ol or 4 pixels of playfield colors 1, L O, O in a row, if the Standard character set 
is used. And the bottom-most line would display playfield colors 1, BAK. BAK. O in 
a row. As may be imagined, it is difficult to recognize such a character. (This 
character is a mirror image left to right — nonsymmetric characters would be 
even more difficult to recognize.) 
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To build a character set tor these modes 12 and 13. then. it is suggested that you 
build each chaxacter as double wide. to allow a total 0 I 8 pixels (by 8 lines) to 
deüne the character. This would also mean assignlng two character set loca- 
tions tor each character and treating each character printed in these modes as 
two characters to be printed. For the example of the W. the character set might 
look like this: 



Byte set L 



Byte 

set 2: 


IO 

OO 

OO 

OO 

OO 

OO 

OO 

IO 

IO 

OO 

OO 

OO 

OO 

OO 

OO 

IO 

IO 

OO 

OO 

IO 

IO 

OO 

OO 

IO 

IO 

OO 

OO 

IO 

IO 

OO 

OO 

IO 

IO 

OO 

IO 

OO 

OO 

IO 

OO 

IO 

IO 

IO 

OO 

OO 

OO 

OO 

IO 

IO 

IO 

IO 

OO 

OO 

OO 

OO 

IO 

IO 

IO 

OO 

OO 

OO 

OO 

OO 

OO 

IO 


Byte set 1 may represent ATASCII value hex 57 within the new character set 
table, and set 2 may be at ATASCII value hex D7 (hex 57 plus hex 80) it desired. 
You may teel free, ot course, to assign your character sets in any manner you 
desire. 

Therefore, it you would print these two characters side by side on the screen it 
would become ettectively a 20 character per line mode, with the resultant 
iO-combination treated as the 1-bit in the mode O example and the OO-combi- 
nation as the O-bit in the mode O example. torming a recognizable W in the 
process. 

Note also that you may want to design these new character sets in a 7 by 7 
matrix starting the upper left hand comer ot the bit-pair set to allow at least one 
blank row and column between each ot the new characters. (This was not 
done in the example.) 

Thus many combinations ot colorful characters may be formed using this tech- 
nique, allowing the user ot the 1200XL additional program fiexibility. 



MEMORY REQUIREMENTS FOR NEW SCREEN MODES 


The following table summarizes the memory utüization for the new modes 12 
through 15. 


Mode 

No. 

Horiz. 

Posit 

Veit 

w/o 

split 

scieen 

Veit 

with 

split 

screen 

Colors 

Data 

Value 

ränge 

Color 

Reg. 

used 

Memory 

Requiied 

(split (full 

screen) screen) 

12 

40 

24 

20 

5 

00-7F 

* 

1154 

1152 

13 

40 

12 

IO 

5 

00-7F 

* 

664 

660 

14 

160 

192 

160 

2 

O 

1 

BAK 

PFO 

4270 

4296 

15 

160 

192 

160 

4 

O 

BAK 

8112 

8138 


1 PFO 

2 PF1 

3 PF2 


*Note: See character deünition foimat for modes 12 and 13. 



CHARACTER D EFINI T I ON FORMAT FOR MODES 12 AND 13 

The lollowlng chcnt shows the layouttor a single character ot the characier set 
which would be used for forming chcnacters in modes 12 and 13. As explained 
above, the value ot each ot the bit pairs specities what color will appecn on a- 
tull-width color clock when this character mode is selected 


7 O 



Bit positions within this line 
Relative byte O 


Relative byte 7 


Each 2 bit color specitication in the character deünition maps to the color regis- 
teis as tollowsi 


If the bits have Then the color register used to select the 

the value: color of the pixel iS: 


O 

1 

2 

3 


BAK 

PFO 


PH 

PF2 if Bit-7'(the color moditier) equals a O, or 
PF3 if Bit-7 (the color moditier) equals a 1. 


The meaning ot the color moditier is shown in the tollowing tables. which show 
the tormats tor the data bytes which are used to produce the display itselt As a 
reminder. the data which is to be displayed on the screen is located soms» 
where in memory The data is located by the address provided in the display 
list The data bytes themselves in these locations will be interpreted according 
to the tollowing table. 


TABLE of DATA FORMATS used for GET CHARACTER/PUT 
CHARACTER for MODES 12 through 15. 

Modes 12,13 M = color moditier bit 7 O 


D = truncated ATASCII 
Mode 1^. C ’ D = color 

Mode 15 D = color 


M 

D 

7 



O 

zero 

D 

7 



O 

zero 

D 
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APPENDIX C — DATA BASE CHANGES FROM REV. B TO 1200 

This appendtx llsis the dlfierence in memory usage between the Rev. B operat- 
ing System ol the A400/800 and the operating System lor the 1200XL 

LOCATION REV. B USE 1200XL USE 


oooo 

reserved 

0001 

reserved 

OOIC 

PTIMOT moved (0314) 

OOID 

PBPNT moved (02DE) 

OOIE 

PBUFSZ moved (02DF) 

OOIF 

PTEMP (deleted) 

0036 

CRETRY moved (0290) 

0037 

DRETRY moved (02BD) 

004A 

CKEY moved (03E9) 

004B 

CASSBT moved (03E9) 

0060 

NEWROW moved (02F5) 

0061 

NEWCOL moved (02F6) 

0062 

NEWCOL moved (02F7) 

0079 

ROWINC moved (02F8) 

007A 

COLINC moved (Ö2F9 

0233 

reserved 

0238-0239 

reserved 

0245 

reserved 

0247 

UNBUF (deleted) 

0248-026A 

LINBUF (deleted) 

026B 

UNBUF (deleted) 

0260 

LINBUF (deleted) 

026D 

LINBUF (deleted) 

026E 

LINBUF (deleted) 

0288 

CSTAT (deleted) 

028E 

reserved 

0290 

TMPX1 (deleted) 

02BD 

HOLD5 (deleted) 

02C902CA 

reserved 

02CB02CC 

reserved 

02CD-02CE 

reserved 

02CF-02D0 

reserved 

02D1-02D2 

reserved 

02D3-02D4 

reserved 

02D5-02D6 

reserved 

02D7-Ö2D8 

reserved 

02D9 ' 

reserved 

02DA 

reserved 

02DB 

reserved 

02DC 

reserved 

02DD 

reserved 

02DE 

reserved 

02DF 

reserved 


LNFLG 

— 

tor inhouse debugger 

NGFLAG 

' — 

for power-up seil test 

ABUFPT 

— 

reserved 

ABUFPT 

— 

reserved 

ABUFPT 

— 

reserved 

ABUFPT 

— 

reserved 

UEMP 

— 

loader temp. 

ITEMP 

— 

loader temp. 

ZCHAIN 

— 

handler loader temp. 

ZCHAIN 

— 

handler loader temp. 

FKDEF 

— 

lunc. key det ptr. 

FKDEF 

— 

func. key det ptr. 

PALNTS 

— 

PAL/NTSC flag. 

KEYDEF 

— 

key det pointer 

KEYDEF 

— 

key det pointer 

LCOUNT 

— 

loader temp. 

RELADR 

— 

loader 

RECLEN 

reserved 

reserved 


loader 

CHSAIT 

— 

character set ptr. 

VSFLAG 

— 

fine scroll temp. 

KEYDIS 

— 

keyboard dlsable 

FINE 

— 

fine scrolling fiag 

HEBYTE 

— 

loader 

NEWADR 

— 

loader 

CRETRY 

— 

Irom 0036 

DRETRY 

— 

lrom0037 

RUN ADR 

— 

loader 

HIUSED 

— 

loader 

ZHIUSE 

— 

loader 

GBYTEA 

— 

loader 

LOADAD 

— 

loader 

ZLOADA 

— 

loader 

DSCTLN 

— 

disk sector size 

ACMISR 

— 

reserved 

KRPDEL 

— 

auto key delay 

KEYREP 

— 

auto key rate 

NOCLK 

— 

key click disable 

HELPFG 

— 

HELP key fiag 

DMASAV 

— 

DMA state save 

PBPNT 

— 

trom OOID 

PBUFSZ 

— 

from OOIE 
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02E9 

reserved 

HNDLOD 

02F5 

reserved 

NEWROW 

02F602F7 

reserved 

NEWCOL 

02F8 

reserved 

ROWINC 

02F9 

reserved 

coLUsrc 

030E 

ADDCOR (deleted) 

JMPERS 

0314 

TEMP2 moved (0313) 

PTMOT 

033D. 

reserved 

PUPBT1 

033E 

reserved 

PUPBT2 

033F 

reserved 

P13PBT3 

03E8 

reserved 

SÜPERF 

03E9 

reserved 

CKEY 

03EA. 

reserved 

CÄSSBT 

03EB 

reserved 

CARTCK 

03ED-03F8 

reserved 

ACMVAR 

03F9 

reserved 

MINTLK 

03FA 

reserved 

GINTLK 

03FB-03FC 

reserved 

CHLINK 









handlex loader flag 

trom 0060 

trom 0061 

trom 0079 

trom 007A 

Option Jumpers 

trom OOIC 

power-up/reset 

power-up/reset 

power-up/reset 

Screeneditor 

from 0O4A 

trom 004B 

cart checksum 

reserved. 

reserved 

cart interlock 

handler chain 
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